Skip to content

Bring README and ARCHITECTURE.md up to date with the pipeline - #95

Merged
LaSav merged 2 commits into
mainfrom
docs/readme-refresh
Nov 19, 2026
Merged

LaSav merged 2 commits into
mainfrom
docs/readme-refresh

Conversation

@LaSav

@LaSav LaSav commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • README: adds the venue, venue-enrich and compute-related steps, so the workflow now matches the 10-stage run-all chain. Also documents the OPENALEX_* env vars and the fact that venue-enrich errors never stop the run, and fills in the Features list (peer review, related papers, all API endpoints).
  • Root ARCHITECTURE.md: fills the same gaps in the data flow, CLI list, owned responsibilities, tables, pipeline_state keys and migrations. Fixes the related-papers description: they're precomputed in paper_related, with live HNSW only as a fallback. Also adds GET /api/authors and the pr/vn compact fields, and removes a stale StatsView note.

Docs only. #96 (stacked on this one) removes centroid-multi and its mentions.

🤖 Generated with Claude Code

Add the venue, venue-enrich and compute-related stages, the full run-all
chain, OpenAlex env vars, paper_related, the peer-review columns, missing
migrations and endpoints; fix the related-papers description (precomputed,
with a live HNSW fallback) and drop a stale StatsView note.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@netlify

netlify Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for alignment-graph canceled.

Name Link
🔨 Latest commit e710697
🔍 Latest deploy log https://app.netlify.com/projects/alignment-graph/deploys/6aff7c79b7ec0a22f5c80cac

Name the run-all stage llm-classify (what --skip accepts), narrow the
venue-enrich soft-failure claim to OpenAlex request errors, and note that
existing papers' stored related lists also go stale between
compute-related runs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@LaSav

LaSav commented Nov 19, 2026

Copy link
Copy Markdown
Contributor Author

AI review: AI-CLEARED

Reviewed e710697 against main.

Findings

No findings.

Every added or changed claim was checked against the code at the PR head and holds: the run-all stage order and --skip names, the scope of venue-enrich's soft failure (OpenAlex request errors only), venue/venue-enrich behaviour and defaults, the OpenAlex env vars, compute-related, related-paper serving and its HNSW fallback, /api/authors, the pipeline_state keys, tables/columns, the migrations list, the compact fields and the removed StatsView note. The three low findings from the previous review (e1f2f28) are fixed in e710697.

@LaSav
LaSav merged commit 7377667 into main Nov 19, 2026
7 checks passed
@LaSav
LaSav deleted the docs/readme-refresh branch November 19, 2026 22:53
@LaSav
LaSav restored the docs/readme-refresh branch November 19, 2026 22:54
@LaSav
LaSav deleted the docs/readme-refresh branch November 19, 2026 22:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant